QR texto plano

Especificación de ticketAccess para la Emisión de Tickets

Al emitir un ticket, es necesario especificar el campo ticketAccess, que determina la información utilizada para el acceso al evento. Este campo es crucial, ya que define cómo se presentará la información de acceso al usuario final.

En la mayoría de los casos, ticketAccess se utiliza para proporcionar un enlace a un código QR que permite a los asistentes acceder al evento. Este enlace es generalmente un URL que al ingresar muestra el código QR correspondiente.

Sin embargo, también ofrecemos la posibilidad de enviar la información de acceso en un formato de texto plano. Esto puede ser útil en situaciones donde no se requiere un código QR, o cuando se prefiera proporcionar un código o identificador de acceso de forma directa.

Ejemplos de Implementación

Aquí, el campo locator contiene un texto o código que puede ser utilizado directamente para el acceso al evento.

"ticketAccess": {
    "type": "OTHER",
    "locator": "D02KWWKS029F"
}

Para crear tickets con QR's de tipo texto debes utilizar el siguiente endpoint:

cURL

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando cURL.

    curl -X POST 'https://api.mentatickets.com/v1/tickets'
    -H 'Authorization: YOUR_API_KEY'
    -H 'Content-Type: application/json'
    --data-raw '[
        {
            "ticketOptionId": "0001",
            "showId": "4726",
            "externalReferenceEventId": "the-lion-king-broadway",
            "buyer": "buyer@emaildomain.com",
            "ticketId": "111",
            "ticketAccess": {
                "type": "OTHER",
                "locator": "D02KWWKS029F"
            },
            "props": {
                "seating": {
                    "row": "A",
                    "seat": "12",
                    "section": "VIP",
                    "door": "North",
                    "image": "https://example.com/seating-image.png"
                }
            }
        }
    ]'

Python

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando Python.

import requests
import json

url = "https://api.mentatickets.com/v1/tickets"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json",
}

ticketOptionId = "0001"
showId = "4726"
externalReferenceEventId = "the-lion-king-broadway"
buyer = "buyer@emaildomain.com"
ticketId = "111"
ticketAccessType = "OTHER"
locator = "D02KWWKS029F"

data = [
    {
        "ticketOptionId": ticketOptionId,
        "showId": showId,
        "externalReferenceEventId": externalReferenceEventId,
        "buyer": buyer,
        "ticketId": ticketId,
        "ticketAccess": {
            "type": ticketAccessType,
            "locator": locator,
            "status": status,
        },
        "props": {
            "seating": {
                "row": "A",
                "seat": "12",
                "section": "VIP",
                "door": "North",
                "image": "https://example.com/seating-image.png"
            }
        }
    }
]

response = requests.post(url, headers=headers, data=json.dumps(data))

Java

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando Java.

import okhttp3.*;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.get("application/json; charset=utf-8");

String ticketOptionId = "0001";
String showId = "4726";
String externalReferenceEventId = "the-lion-king-broadway";
String buyer = "buyer@emaildomain.com";
String ticketId = "111";
String ticketAccessType = "OTHER";
String locator = "D02KWWKS029F"

String json = String.format("""
        [
            {
                "ticketOptionId": "%s",
                "showId": "%s",
                "externalReferenceEventId": "%s",
                "buyer": "%s",
                "ticketId": "%s",
                "ticketAccess": {
                    "type": "%s",
                    "locator": "%s",
                    "status": "%s"
                },
                "props": {
                    "seating": {
                        "row": "A",
                        "seat": "12",
                        "section": "VIP",
                        "door": "North",
                        "image": "https://example.com/seating-image.png"
                    }
                }
            }
        ]
        """, ticketOptionId, showId, externalReferenceEventId, buyer, ticketId, ticketAccessType, locator, status);

RequestBody body = RequestBody.create(JSON, json);
Request request = new Request.Builder()
        .url("https://api.mentatickets.com/v1/tickets")
        .post(body)
        .addHeader("Authorization", "YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

PHP

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando PHP.

<?php
$url = "https://api.mentatickets.com/v1/tickets";
$headers = array(
    "Authorization: YOUR_API_KEY",
    "Content-Type: application/json",
);

$data = array(
    array(
        "ticketOptionId" => "0001",
        "showId" => "4726",
        "externalReferenceEventId" => "the-lion-king-broadway",
        "buyer" => "buyer@emaildomain.com",
        "ticketId" => "111",
        "ticketAccess" => array(
            "type" => "OTHER",
            "locator" => "D02KWWKS029F",
        ),
        "props" => array(
            "seating" => array(
                "row" => "A",
                "seat" => "12",
                "section" => "VIP",
                "door" => "North",
                "image" => "https://example.com/seating-image.png"
            )
        )
    )
);

$json_data = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Respuesta JSON

{
    "status": 200,
    "data": [{TICKETDATA}],
    "errors": null
}

Para mas información detallada de Ticket y Seating diríjase a la sección de datos de ticket